home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- A U T O R E S T O R E
-
- for
-
- S T O W A W A Y
-
- -------------------------
- Users Guide and Reference
- -------------------------
-
-
-
-
- Version 1.1ß
- July 1992
-
-
-
-
- ┌─────────┐
- ┌─────┴───┐ │ (tm)
- │ │o │──────────────────
- │ ┌─────┴╨──┐ │ Association of
- │ │ │─┘ Shareware
- └───│ o │ Professionals
- ────│ ║ │────────────────────
- └────╨────┘ * Member *
-
- Patri-Soft
-
- (714) 352-2820 (Voice)
- (714) 352-2825 (BBS)
- (714) 352-1527 (FAX)
-
- Copyright 1992 by Patri-Soft
-
-
-
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
-
-
- Table of Contents
-
-
- About Shareware........................................... 1
- Disclaimer................................................ 1
- ASP....................................................... 1
- How To Register........................................... 2
- About Auto Restore........................................ 3
- Sytem Requirements........................................ 4
- Getting the Most From Auto Restore........................ 4
- How Auto Restore Works.................................... 5
- Installing Auto Restore................................... 5
- Setting Stowaway options................................ 5
- Starting Auto Restore................................... 5
- Disabling/enabling AutoRestore............................ 5
- Removing Auto Restore from Memory......................... 6
- Messages.................................................. 6
- Reporting problems or Suggesting enhancments.............. 10
-
-
-
-
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
-
- About Shareware
-
- Shareware is Try Before you Buy software! Shareware is not free and
- most shareware is not developed as a hobby! Patri-Soft grants you 30
- days to evaluate this program without risk or obligation. After that
- time, you must remove the program from your system, or purchase it
- through Patri-Soft or one of our authorized distributors.
-
- Shareware authors, including us, work many, many hours to create good
- quality software hoping to make a reasonable living (like those
- striving to be actors or professional athletes, very few are
- successful). We are well aware that our success depends on you. We
- make every effort to provide you with good software at low prices. In
- return, we hope you will support our efforts. Without your support,
- many good shareware programs die as their authors are unable to
- continue to support and enhance products without income. Please pay
- for the shareware you use so you can keep getting great software at
- reasonable prices!
-
-
- Disclaimer
-
- Like most other software, use of this program acknowledges this
- disclaimer of warranty:
-
- "THIS PROGRAM IS SUPPLIED 'AS IS'. PATRI-SOFT DISCLAIMS ALL
- WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
- LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS
- OF THIS PROGRAM FOR ANY PURPOSE. PATRI-SOFT ASSUMES NO
- LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY
- RESULT FROM THE USE OF THIS PROGRAM."
-
-
- Patri-Soft is a member of the ASP
-
- This program is produced by a member of the Association of
- Shareware Professionals (ASP). ASP wants to make sure that the
- shareware principle works for you. If you are unable to resolve a
- shareware-related problem with an ASP member by contacting the
- member directly, ASP may be able to help. The ASP Ombudsman can
- help you resolve a dispute or problem with an ASP member, but does
- not provide technical support for members' products. Please write
- to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send
- a Compuserve message via easyplex to ASP Ombudsman 70007,3536
-
-
-
- Page 1
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
-
-
- How to Register your version of Auto Restore
-
-
-
- If you use Auto Restore, please register your use and support
- shareware. Ordering your version of Auto Restore is EASY! You may
- register in a variety of ways:
-
-
-
- 1) Print ORDER.FRM, fill it out, and mail it to us. We will
- gladly accept check, money orders, or Visa/Master card in the
- mail.
-
- 2) Call 1-800-272-4775 to place your order with Public Software
- Library. PsL accepts almost every kind of credit card.
-
- 3) Call the Patri-Soft BBS at (714) 352-2825 and register
- On-line by filling out script questionnaire 2. (At the main
- menu, press 'S'). A Visa or MasterCard is necessary for this
- process.
-
- 4) Call Patri-Soft at 714-352-2820. At this number, we accept
- Visa, MasterCard, Purchase order, or we can bill you.
-
- 5) FAX your purchase order or order form to us at (714)
- 352-1527.
-
- In all cases, your order is shipped the next day. Please add an
- additional $5.00 for purchase orders.
-
- The file ORDER.FRM has been provided to mail or FAX to us.
-
- NOTE: Area code 714 changes to 909 in November 1992.
-
-
-
-
- When you register, we will send you the latest version of
- Stowaway, and the latest, registered version of Auto Restore.
- Registration entitles you to extended technical support,
- notification of updates, a registered version, and other
- benefits!
-
-
-
-
-
- Page 2
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- ------------------------------------------------------------------
-
- About Stowaway's Auto Restore
-
- Auto Restore is a complimentary product to Stowaway, Patri-Soft's file
- archival system. Stowaway, lets you select files to be moved off your
- hard disk to inexpensive diskette storage. The unique feature of
- Stowaway is that it keeps hard disk indexes about every file it
- stores. These indexes are used to easily locate any file stored on
- archive volumes without having to access the individual volumes.
-
- When you need to restore an archived file, Stowaway lets you enter
- filenames or wildcard specifications to list and select the file to be
- restored. It asks for the disk containing the file and restores it to
- its proper location. This is a manual process that must be performed
- prior to accessing the file with DOS or any other application. You
- must know the file that needs to be restored. Stowaway's Auto Restore
- automates this process.
-
- Auto Restore is installed when you start your computer and resides
- in your system watching all file accesses. It detects when any
- program attempts to access a file that has been archived. It can
- do this because Stowaway optionally leaves the archived file on the
- hard disk with zero size and a time of 12:00am and therefore the
- file occupies no space but is still visable. When any program tries
- to read or write one of these files, Auto Restore searches
- Stowaway's archive indexes to verify the file is archived and, if
- so, displays a window on your display to tell you an archived file
- has been referenced and asks if you would like to restore it for
- processing.
-
- If you respond yes to restore the file, Auto Restore then asks you to
- place the archive volume in the drive and proceeds to restore the
- file. If you respond no, Auto Restore notifys DOS, and subsequently
- your program or command, the file is inaccessable. The program or
- command accessing the file will take its normal action when a file is
- not accessible.
-
- After the restore is complete, the text window is removed from your
- display and the active program or command continues its normal
- operation. Auto Restore goes back to waiting for the next archived
- file to be accessed.
-
- Auto Restore gives you additional freedom to archive more files to
- offline storage volumes. Since it takes care of all restore processing
- automatically, you can archive files and trust they will be
- immediately accessible anytime they are needed.
-
- Since Stowaway keeps directory entries on your hard disk for all
- archived files, you still can list and search for files as you have
- always been able to do. But they no longer take up valuable hard disk
- space
- Page 3
-
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
- Auto Restore may be temporarily disabled at any time by issuing a DOS
- command. It will remain in memory until enabled by a second command
- or until the system is turned off.
-
- Note: Auto Restore does not work with alternate IDs at this time.
- Only the regular ID will be searched.
-
- System Requirements
-
- Any PC, XT, or AT type machine.
- Stowaway requires 350K of memory while archiving files
- Auto Restore requires less than 30K of memory when installed
- A hard disk is required. 500k program disk space used.
- Stowaway will archive as a DOS Windows application
- Auto Restore will not restore when graphics displays are active.
-
- Getting the Most from Auto Restore
-
- Here are some ideas for using Stowaway and Auto Restore to free up
- expensive hard disk space:
-
- Archive old word processing, or spreadsheet files. Your directories
- will still have the names of all the archived files, and when you load
- one of the files using your word processor, Auto Restore will pup-up
- and start the restore.
-
- Archive graphics, picture and clip-art files. Their names are
- still in the directories for quick access.
-
- Reduce the amount hard disk space required by software products.
- Many times, software products install many files you will never
- use. These exist of example files, installation notes, read.me
- files, printer drivers, display drivers, fonts, and much more.
- You would like to remove what is not needed but are not
- absolutely sure what files are not needed. Use Stowaway to
- archive the files you think are not needed. Then run your
- program normally. Auto Restore will detect any access to
- archived files and automatically restore them. FIles needed will
- be restored and those never accessed will stay in the archives.
-
- Clean up hard disk utilities and save files without worry if they
- are every accessed. If you needed them, just type their name.
- They will be immediately restored.
-
- With Stowaway and Auto Restore, you can have the cleanest hard disk
- posible. Hard disks never seem to be large enough. Stowaway will
- make sure you are always making best use of your space.
-
- Page 4
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
-
- How Auto Restore Works
-
- Auto Restore installs itself in memory and then watches all open
- functions that are used to prepare a file for reading or writing.
- This type of process is often referred to as a Terminate and Stay
- Resident (TSR) application. During its operation, it intercepts the
- requesting program's process to restore a file. Auto Restore than
- uses the Stowaway index to determine if the file is an archived
- file, and it so, restores it.
-
- Installing Auto Restore
-
- Installing Auto Restore is easy. The Auto Restore program AR.EXE must
- be kept with Stowaway program in Stowaway's directory on your hard
- disk. It uses Stowaway option and index files for its operation.
-
-
- Setting Stowaway Options
-
- For auto Restore to operate, Stowaway needs to prepare the
- files for Auto Restore. In the system options, set Stowaway
- so that archived files will be prepared for Auto Restore (If
- files are already archived, select "Prepare files for
- Auto-Restore" in the utility menu). Stowaway will leave a
- zero byte file in the directory, so that the file is "there"
- but occupies no space.
-
- Start Stowaway and access its Options specifications
- to specify this option.
-
- Starting Auto Restore
-
- Enter the AR command to install Stowaway. This must be done
- when no other programs are running in your system.
- Normally, you will place the AR command in your AUTOEXEC.BAT
- file to be executed every time your system is started. See
- your DOS manual if you are unfamiliar with the AUTOEXEC.BAT
- file or how to change it. NOTE: AR.EXE HAS to be in the
- same directory as STOW.EXE.
-
- C> AR<ENTER> <=== To install Auto Restore
-
- Disabling and enabling Auto Restore
-
- You may not want Auto Restore to be active while using some
- programs or commands. For example, you do not want to have Auto
- Restore active during your system backup as backup will access
- the file and Auto Restore will attempt to restore archived files
- before backup (Note, Patri-Soft's MegaBack backup system is aware
-
- Page 5
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
- of auto restore and will automatically backup the directory entry
- for archvied files without causing them to be restored).
-
- To temporarily disable auto restore, enter the AR command with
- the /D command parameter specified.
-
- AR /D <=== Use to disable Auto Restore
-
- To reenable Auto Restore after it has been disabled, enter the AR
- command with the /E command parameter specified.
-
- AR /E <=== Use to enable Auto Restore
-
- The AR command to disable and enable auto restore processing may
- be placed in batch files, or menu specifications, before backup
- or other commands. This will let you automatically disable and
- enable processing when needed.
-
- Removing Auto Restore from Memory
-
- To remove Auto Restore from memory, restart your system by
- rebooting it or by turing it off and back on.
-
- Messages
-
- 1 -- DOS level less than 3.00? Unable to locate execute dirname
-
- DOS normally passes the directory name a program is being
- executed from as the first parameter to a program. When
- AR.EXE was executed, it was not able to determine where it
- was executed from. Check your DOS operating system level or
- environment executing AR.EXE.
-
-
- 2 -- Cannot access STOSAWAY.DAT. Run AR.EXE from Stowaway directory
- AR.EXE looks for Stowaway's option file STOSWAWY.DAT in the
- same directory it is run from. It was not found. Make sure
- AR.EXE is in the same directory as STOSAWAY.DAT.
-
-
- 3 -- Cannot read the file STOSAWAY.DAT
- AR was unable to access STOWAWAY.DAT. Verify security or
- file attributes allow your access to the file.
-
-
- 4 -- Auto-restore cannot access ARCHIVE.DAT
- ARCHIVE.DAT is the file containing the archive data on the
- archive volume. Either an incorrect or invalid archive
-
- Page 6
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
- volume was mounted. Verify the correct archive drive is
- being used. AR uses Stowaway options to determine the
- archive volume to use.
-
-
- 5 -- Seek Error locating beginning of archived file.
- AR was attempting to position to read somewhere on the
- archive volume but received an error. Either an incorrect or
- invalid archive volume was mounted. Also, an archive index
- may not be the correct index for the volume mounted.
-
- 6 -- Error reading start of archived file
- AR was attempting to read somewhere on the archive volume
- but received an error. Either an incorrect or invalid
- archive volume was mounted. Also, an archive index may not
- be the correct index for the volume mounted.
-
-
- 7 -- Seek error locating data of archive file
- AR was attempting to read somewhere on the archive volume
- but received an error. Either an incorrect or invalid
- archive volume was mounted. Also, an archive index may not
- be the correct index for the volume mounted.
-
- 8 -- Archive header filename does not match index record
- AR read the data from an archive volume but found it was not
- the correct data for the file to be restored. Either an
- incorrect or invalid archive volume was mounted. Also, an
- archive index may not be the correct index for the volume
- mounted.
-
-
- 9 -- Error opening output file for write. Must exist and be 0 len
- AR was unable to create the file to be restored on the
- target hard disk. Make sure there is sufficient space to
- hold the file and that you have authorization to create
- files on the volumes (networks).
-
- 10 -- Error writing to output file - disk out of space?
- AR was unable to write the file to be restored on the target
- hard disk. Make sure there is sufficient space to hold the
- file and that you have authorization to create files on the
- volumes (networks).
-
- 11 -- Error decompressing archive data
- AR encountered an error decompressing archive data. Verify
- the archive volume is the correct one for the index being
-
- Page 7
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
- used. This error can also be encountered if archive data
- has been corrupted by software or hardware error. Use the
- CHKDSK command to verify the volume is properly formatted
- without errors.
-
-
- 12 -- Unable to reset files date and time
- Once AR restored the file, it was unable to reset the
- restored file's date and time to reflect the value of the
- original archived file. Verify you have authorization to
- set file's date and times (networks).
-
-
- 13 -- Unable to properly set files attributes
- Once AR restored the file, it was unable to reset the
- restored file's attributes to reflect the value of the
- original archived file. Verify you have authorization to
- set file's atttributes (networks).
-
- 14 -- Error reading archive file data
- AR was attempting to read somewhere on the archive volume
- but received an error while reading the data. The data on
- the archive volume has been corrupted or was not written
- successfully ar archive time. Attempt to copy the archive
- volume to another space volume using the DOS DISKCOPY
- command. Use the new volume and attempt the restore again.
- Use the DOS CHKDSK command to verify the volume is correctly
- formatted and has no errors.
-
- Remember, always use the best quality media and hardware
- when creating archive data!
-
-
- 15 -- Error accessing STOFILIX.DAT
- AR was unable to locate or access Stowaway's file index. It
- should be located in the same directory AR was started from.
- Verify it exists and can be accessed.
-
-
- 16 -- Error in seek to the file index, STOFILIX.DAT.
- AR was able to locate and access Stowaway's file index but
- was unable to read it successfully. Verify the file is
- valid. Use the DOS CHKDSK command to verify the file volume
- is correctly formatted and has no errors.
-
-
- 17 -- Error reading STOFILIX.DAT.
- AR was able to locate and access Stowaway's file index but
-
- Page 8
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
-
- was unable to read it successfully. Verify the file is
- valid. Use the DOS CHKDSK command to verify the file volume
- is correctly formatted and has no errors.
-
- 18 -- Error accessing VOLnnnn.VOL on archive disk
- AR was unable to locate or access Stowaway's volume contents
- file on the arhcive volume. Verify the file exists and is
- valid. Verify the correct archive volume is being used for
- the restore.
-
-
- 19 -- Error reading VOLnnnn.VOL on archive disk
- AR was able to locate and access Stowaway's volume contents
- file on the arhcive volume but was unable to read it
- successfully. Verify the file is valid. Use the DOS CHKDSK
- command to verify the file volume is correctly formatted and
- has no errors.
-
-
- 20 -- The file to be restored was not in the archive index?
- Ar found a archive file place holder on your hard disk
- indicating the original file was archived. This is a zero
- lenggth file with a time of 12:00AM. AR attempted to locate
- the file in the Stowaway archive index but did not find a
- corresponding entry. Verify the Stowaway index used when AR
- was started is correct for the disk volume.
-
- To correct this problem. use the DOS delete command to
- remove the file place holder file on your hard drive.
-
-
- 21 -- User terminated restore request by pressing Escape
- AR requested to restore an archive file but the user
- rejected the request to restore the file by responding No
- when asked for permission to restore.
-
-
- 22 -- Cannot restore file as screen is in graphics mode
- An application or command atttempted to restore a file while
- the display was in graphics mode. AR is unable to restore
- files while the display is in graphics mode. The restore
- request generated, as a result of the attempted file access,
- was rejected.
-
- You may consider disabling AR with the AR /D command before
- running this application again. The, AR will not attempt to
- restore the file. Use the AR /E command to reenable AR
- after the graphics application completes.
-
- Page 9
-
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
- 23 -- Application has not supplied full pathname. Unknown directory
- AR was unable to determine where to restore a file as the
- file was not accessed with a complete DOS pathname. The
- restore request cannot be complated. Enter the full
- pathname for the command or in the application requesting
- the restore.
-
-
- 24 -- Auto Restore is already installed
- The AR command was issued without parameter to install auto
- restore but auto restore was already installed.
-
-
- 25 -- Error in command line parameters
- The AR command was entered with an invalid command line
- parameter. Verify the command line with the valid
- parameters for AR.
-
- 26 -- Auto Restore is not active. Cannot change status.
- The AR command was entered with the /D or /E parameter to
- enable or disable restore processing but AR was not
- previously installed. Enter the AR command without
- parameters to install it in your system before using the /E
- or /D parameters.
-
-
- 27 -- User has terminated restore request through response.
- During AR restore processing, the user has cancelled the
- restored at some point in processing.
-
-
- Reporting Problems or Suggesting Enhancments
-
- Patri-Soft is ALWAYS interested in improving it's products. If you
- discover a problem, or have a suggestion, we want to hear from you!
- You may contact us at Patri-Soft in a variety of ways:
-
- Patri-Soft
- 5225 Canyon Crest Dr.
- Suite 71-358
- Riverside CA, 92507
-
- (714) 352-2820 Voice
- (714) 352-1527 FAX
- (714) 352-2825 DATA
- Note: Area code 714 changes to 909 in November 1992.
-
- Page 10
-
-
- Auto Restore for Stowaway Copyright 1992 by Patri-Soft
- -----------------------------------------------------------------
-
-
- Feel free to contact us at any of the above numbers, or write us a
- letter.
-
- When reporting problems, please have the following information
- available:
-
- Version of the product
- DOS version
- Machine type
-
- Note: Technical support is most effective when you are in front
- of your computer when you call. We are able to help you most
- effectivly when you can guide us step by step through the problem
- or question.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Page 11
-